From 1e4925db7fbee42ba80b278679adf439d3f9ed6b Mon Sep 17 00:00:00 2001 From: robertl Date: Sat, 18 Nov 2006 07:14:41 +0000 Subject: [PATCH] A slew of doc edits to increase product linkage. --- xmldoc/formats/arc.xml | 8 ++++++++ xmldoc/formats/coastexp.xml | 2 +- xmldoc/formats/cst.xml | 2 +- xmldoc/formats/csv.xml | 11 +++++++++-- xmldoc/formats/fugawi.xml | 2 +- xmldoc/formats/gcdb.xml | 2 +- xmldoc/formats/gdb.xml | 3 ++- xmldoc/formats/geo.xml | 2 +- xmldoc/formats/glogbook.xml | 6 +++++- xmldoc/formats/google.xml | 2 +- xmldoc/formats/gpilots.xml | 8 +++----- xmldoc/formats/gpsutil.xml | 10 +++++++--- xmldoc/formats/gpx.xml | 5 +++++ xmldoc/formats/holux.xml | 2 +- xmldoc/formats/kml.xml | 2 +- xmldoc/formats/lowranceusr.xml | 2 +- xmldoc/formats/magellan.xml | 2 +- xmldoc/formats/magellan1.xml | 2 +- xmldoc/formats/magellanx.xml | 6 +++--- xmldoc/formats/maggeo.xml | 4 ++-- xmldoc/formats/magnav.xml | 2 +- xmldoc/formats/mapsend.xml | 2 +- xmldoc/formats/nmea.xml | 6 ++++++ xmldoc/formats/options/tpg-datum.xml | 5 +++-- xmldoc/formats/pcx.xml | 7 +++++-- xmldoc/formats/s_and_t.xml | 5 +++-- xmldoc/formats/saplus.xml | 2 +- xmldoc/formats/tmpro.xml | 4 ++-- xmldoc/formats/tomtom.xml | 2 +- xmldoc/formats/xmap.xml | 5 +++-- xmldoc/formats/xmap2006.xml | 4 +++- xmldoc/formats/xmapwpt.xml | 4 ++-- 32 files changed, 86 insertions(+), 45 deletions(-) diff --git a/xmldoc/formats/arc.xml b/xmldoc/formats/arc.xml index a10c27ad1..4365cce28 100644 --- a/xmldoc/formats/arc.xml +++ b/xmldoc/formats/arc.xml @@ -4,3 +4,11 @@ This format is used by GPSBabel itself as the input to the polygon filters. See those filters for more information. + +The arc format reads two numeric fields, a latitude and a longitude, +in any format recognized as human +readable and writes as simple degrees decimal. It really is +intended for GPSBabel's own internal use more than general use, though +it turns out to be a convenient way of expressing simple polylines and +polygons. + diff --git a/xmldoc/formats/coastexp.xml b/xmldoc/formats/coastexp.xml index 066e29fcf..3356a9fff 100644 --- a/xmldoc/formats/coastexp.xml +++ b/xmldoc/formats/coastexp.xml @@ -1,7 +1,7 @@ - This is the format used by CoastalExplorer (tm). The + This is the format used by CoastalExplorer. The format is XML with items uniquely identified by Windows-style UUIDs. http://www.rosepointnav.com diff --git a/xmldoc/formats/cst.xml b/xmldoc/formats/cst.xml index 835c162d1..85890bad8 100644 --- a/xmldoc/formats/cst.xml +++ b/xmldoc/formats/cst.xml @@ -2,7 +2,7 @@ With this format we can read CarteSurTabledata files. - CarteSurTableis a shareware program widely used in France. The data + CarteSurTable is a shareware program widely used in France. The data inside have to be seen as a mixture of a waypoints list, one route and several tracks. diff --git a/xmldoc/formats/csv.xml b/xmldoc/formats/csv.xml index 46f6f68d4..3b2e1112c 100644 --- a/xmldoc/formats/csv.xml +++ b/xmldoc/formats/csv.xml @@ -2,7 +2,7 @@ There are a billion variants of Comma Separated Value -data. This is the one that makes Delorme" S&A Deluxe 9 happy. It's +data. This is the one that makes Delorme S&A Deluxe 9 happy. It's also a very simple program and useful for many other programs like spreadsheets. CSV is also the correct format for @@ -10,4 +10,11 @@ spreadsheets. their commercial mapping program, or GDM6 (their free waypoint manager) for iFinder which is available at lowrance.com - + + On write, this format writes simple "latitude, longitude" pairs, but +on read it will read anything supported by our human readable definition. + + + For something-separated data that has headers identifying the various + fields, see our universal csv format. + diff --git a/xmldoc/formats/fugawi.xml b/xmldoc/formats/fugawi.xml index 8975401a8..51b819f79 100644 --- a/xmldoc/formats/fugawi.xml +++ b/xmldoc/formats/fugawi.xml @@ -1,7 +1,7 @@ - This was a requested CSV format, *not* the proprietary + This was a requested CSV format, and is not the proprietary binary format used by Fugawi. Like any other CSV format, GPSBabel cannot read tracks in this format, but converting a track into it and then importing as track in Fugawi works. diff --git a/xmldoc/formats/gcdb.xml b/xmldoc/formats/gcdb.xml index 6e7408429..d9e1d4d53 100644 --- a/xmldoc/formats/gcdb.xml +++ b/xmldoc/formats/gcdb.xml @@ -1,7 +1,7 @@ This is format for the -GeocachingDBprogram by DougsBrat. It works with v2 +GeocachingDB program by DougsBrat. It works with v2 and v3 of this program. diff --git a/xmldoc/formats/gdb.xml b/xmldoc/formats/gdb.xml index eb25c0b8b..80788965e 100644 --- a/xmldoc/formats/gdb.xml +++ b/xmldoc/formats/gdb.xml @@ -1,6 +1,7 @@ Support for the "Garmin GPS Database" format used by -default in MapSource versions since release 6.0. By default GPSBabel creates +default in MapSource versions since release 6.0 of +that product. By default GPSBabel creates gdb files of version 2. Version 2 is used in Mapsource 6.3 and 6.5. diff --git a/xmldoc/formats/geo.xml b/xmldoc/formats/geo.xml index 7cd659e09..42c1b22a1 100644 --- a/xmldoc/formats/geo.xml +++ b/xmldoc/formats/geo.xml @@ -1,5 +1,5 @@ -This format supports the Geocaching.com/EasyGPS ".loc" format. This format +This format supports the Geocaching.com/EasyGPS ".loc" format. This format was created specifically for Geocaching.com and is not the same as the standard EasyGPS .loc format. See the EasyGPS or GPX formats for more general EasyGPS support. diff --git a/xmldoc/formats/glogbook.xml b/xmldoc/formats/glogbook.xml index c79db28f6..bbaa7b02b 100644 --- a/xmldoc/formats/glogbook.xml +++ b/xmldoc/formats/glogbook.xml @@ -2,6 +2,10 @@ This is the XML format used by the Garmin Logbook product -that ships with Forerunner and Foretrex. http://www.garmin.com +that ships with Forerunner and Foretrex. +As of early 2006, this program is apparently been discontinued in favor of +Garmin Training Center. + +See: http://www.garmin.com diff --git a/xmldoc/formats/google.xml b/xmldoc/formats/google.xml index f564951ae..d458c7cb1 100644 --- a/xmldoc/formats/google.xml +++ b/xmldoc/formats/google.xml @@ -2,7 +2,7 @@ This format is designed to read the XML emitted when you -tack "&output=js" onto the end of a Google Maps route URL (use +tack "&output=js" onto the end of a Google Mapsroute URL (use the "link to this page" option to get a usable URL.) This allows you to plan a route using Google Maps, then download it and use it in your own mapping program or GPS receiver. To get a file suitable for use diff --git a/xmldoc/formats/gpilots.xml b/xmldoc/formats/gpilots.xml index c3c9dd450..ffb947cdd 100644 --- a/xmldoc/formats/gpilots.xml +++ b/xmldoc/formats/gpilots.xml @@ -1,12 +1,10 @@ - This is a Palm/OS file format for GPilotS. It was tested -against version 6.2. + This is a Palm/OS file format for + GPilotS. + It was tested against version 6.2 of GPilotsS - - http://www.cru.fr/perso/cc/GPilotS/ - Neither tracks nor routes are supported at this time. diff --git a/xmldoc/formats/gpsutil.xml b/xmldoc/formats/gpsutil.xml index 52f2f9237..d39bd8d79 100644 --- a/xmldoc/formats/gpsutil.xml +++ b/xmldoc/formats/gpsutil.xml @@ -1,8 +1,12 @@ - GPSUtil has a simple file format of this program that runs + The format we call gpsutil is a simple file format used by a program that runs on POSIX- compliant OSes like UNIX and Linux. Reads and writes of -this format are reliable. (I've also contributed to this program.) -It's available at cs.uakron.edu. +this format are very reliable. (The lead +developer of GPSBabel also contributed to this that 'gpsutil' +the early days.) + + Note that 'gpsutil' is a different format - and program - than the one called GPS Utility; for that one, you should probably use our PCX module. + diff --git a/xmldoc/formats/gpx.xml b/xmldoc/formats/gpx.xml index 1af5de8d9..9f68c0ae2 100644 --- a/xmldoc/formats/gpx.xml +++ b/xmldoc/formats/gpx.xml @@ -6,4 +6,9 @@ formats supplied. It is described at topografix.com + + GPSBabel's reader of this module attempts to preserve tags it doesn't + really understand. It also tries to glean interesting data from + pocket queries from Geocaching.com. + diff --git a/xmldoc/formats/holux.xml b/xmldoc/formats/holux.xml index be227fb38..8524b1483 100644 --- a/xmldoc/formats/holux.xml +++ b/xmldoc/formats/holux.xml @@ -1,7 +1,7 @@ - The Holuxgm-100 (e-fox) gps receiver uses standard + The Holux gm-100 (e-fox) gps receiver uses standard compact flash cards. File formats were provided by Holux-Taiwan holux.com to the author. The code was tested against version 2.27E1; other versions and diff --git a/xmldoc/formats/kml.xml b/xmldoc/formats/kml.xml index a77c7238c..b35632ba0 100644 --- a/xmldoc/formats/kml.xml +++ b/xmldoc/formats/kml.xml @@ -1,6 +1,6 @@ KML, the Keyhole Markup Language, is used by Keyhole and -Google Earth. There are features in this file format that GPSBabel +Google Earth. There are features in this file format that GPSBabel doesn't support - such as camera views - but waypoints, tracks, and routes work well. diff --git a/xmldoc/formats/lowranceusr.xml b/xmldoc/formats/lowranceusr.xml index 79a34410a..f2383eb91 100644 --- a/xmldoc/formats/lowranceusr.xml +++ b/xmldoc/formats/lowranceusr.xml @@ -1,5 +1,5 @@ -The Lowrance iFinder GPS series has the unique capability +The Lowrance iFinder GPS series has the unique capability to output its data to an MMC card. The data is saved to the card as a .USR file and can be read by your computer using a card reader. Waypoints, routes, tracks are supported. By default, Event marker diff --git a/xmldoc/formats/magellan.xml b/xmldoc/formats/magellan.xml index bc671532e..c51a80830 100644 --- a/xmldoc/formats/magellan.xml +++ b/xmldoc/formats/magellan.xml @@ -1,4 +1,4 @@ -GPSBabel supports the following Magellan receivers: +GPSBabel supports the following Magellan receivers: 310 315 diff --git a/xmldoc/formats/magellan1.xml b/xmldoc/formats/magellan1.xml index 2ee5fbf23..88fd94eb2 100644 --- a/xmldoc/formats/magellan1.xml +++ b/xmldoc/formats/magellan1.xml @@ -1,4 +1,4 @@ -GPSBabel supports the following Magellan receivers: +GPSBabel supports the following Magellan receivers: 310 315 diff --git a/xmldoc/formats/magellanx.xml b/xmldoc/formats/magellanx.xml index be4fa14a9..b2f0e712f 100644 --- a/xmldoc/formats/magellanx.xml +++ b/xmldoc/formats/magellanx.xml @@ -1,8 +1,8 @@ - This is the SD card format used by the Magellan Explorist 400, + This is the SD card format used by the Magellan Explorist 400, 500, 600, and XL and internally on those devices plus the - Explorist 210. Waypoints are identical to the Magellan SD format - used by Meridian, but allows longer waypoint names. Routes are + Explorist 210. Storeed waypoints are identical to the Magellan SD format + used by Meridian, but the newer models allow longer waypoint names. Routes are subtly different. diff --git a/xmldoc/formats/maggeo.xml b/xmldoc/formats/maggeo.xml index 506567d13..ea97b5352 100644 --- a/xmldoc/formats/maggeo.xml +++ b/xmldoc/formats/maggeo.xml @@ -1,8 +1,8 @@ - The SD card format used by the Magellan Explorist 400, -500, and 600 to describe geocaches. Notice what while the format can + The SD card format used by the Magellan > 400, +500, 600, 210, and XL to describe geocaches. Notice what while the format can hold an infinite number of geocaches, the unit will read and silently discard all but 200 geocache POIs at a time. You should name any file created with this format with a diff --git a/xmldoc/formats/magnav.xml b/xmldoc/formats/magnav.xml index a06a0490e..d2db2020f 100644 --- a/xmldoc/formats/magnav.xml +++ b/xmldoc/formats/magnav.xml @@ -1,5 +1,5 @@ -Magellan NAV Companion for Palm/OS is not really designed +Magellan NAV Companion for Palm/OS is not really designed for this sort of use, but its file format is supported and with a little bit of patience you can both read and write NAV Companion waypoints. This conversion is based on diff --git a/xmldoc/formats/mapsend.xml b/xmldoc/formats/mapsend.xml index 0dc62d684..a33cdc3bc 100644 --- a/xmldoc/formats/mapsend.xml +++ b/xmldoc/formats/mapsend.xml @@ -1,5 +1,5 @@ -This format supports the Magellan MapSend native +This format supports the Magellan MapSend native file format. diff --git a/xmldoc/formats/nmea.xml b/xmldoc/formats/nmea.xml index 955f55e4c..9bfc29a67 100644 --- a/xmldoc/formats/nmea.xml +++ b/xmldoc/formats/nmea.xml @@ -34,3 +34,9 @@ that work with NMEA-0183 formatted data include: SparkFun GPS Datalogger + +This module also supports realtime tracking +which allows realtime position reports from a GPS, such as one connected +serially, over Bluetooth, or a USB module emulating a serial port, to be used +with selected output formats. + diff --git a/xmldoc/formats/options/tpg-datum.xml b/xmldoc/formats/options/tpg-datum.xml index 679556531..f215467ff 100644 --- a/xmldoc/formats/options/tpg-datum.xml +++ b/xmldoc/formats/options/tpg-datum.xml @@ -1,5 +1,6 @@ The option 'datum="datum name"' can be used to override the default of NAD27 ("N. America 1927 mean") which is correct for the -continental U.S. Points in Hawaii should use "Old -Hawaiian_mean" +continental U.S. Any legal datum supported +by GPSBabel may be used. For example, points in Hawaii should +use "Old Hawaiian_mean". diff --git a/xmldoc/formats/pcx.xml b/xmldoc/formats/pcx.xml index 428670cae..60abecec5 100644 --- a/xmldoc/formats/pcx.xml +++ b/xmldoc/formats/pcx.xml @@ -5,9 +5,12 @@ the lame NMEA six-character waypoint names that's treated as a second-class citizien in current versions of MapSource. In Mapsource, use file->import to read these files. If you name the files *.wpt, -Mapsource will find them easier. +Mapsource will find them more easily. In general, you should prefer the "mapsource" file format to this one. - + This format has been extended to handle many - but not all - + files from GPS Utility. If you encounter something that GPSBabel does not handle well, use +the free version of GPSUtil to read it and save as something more common. + diff --git a/xmldoc/formats/s_and_t.xml b/xmldoc/formats/s_and_t.xml index ce0e8cc26..1b82e49c4 100644 --- a/xmldoc/formats/s_and_t.xml +++ b/xmldoc/formats/s_and_t.xml @@ -1,8 +1,9 @@ - This is a format for importing into Microsoft Streets and -Trips. It's been exercised on versions 2003, 2004, and 2005. Detailed + This is a format for importing into + Microsoft Streets and +Trips. It's been exercised on versions from 2003 through 2007. Detailed instructions on how to use it, including preserving hyperlinks, are at gpsbabel.org diff --git a/xmldoc/formats/saplus.xml b/xmldoc/formats/saplus.xml index 4073e0f27..2c30a046d 100644 --- a/xmldoc/formats/saplus.xml +++ b/xmldoc/formats/saplus.xml @@ -1,7 +1,7 @@ - This format is for Street Atlas USA 2004 Plus. + This format is for Delorme Street Atlas USA 2004 Plus and later. For geocachers importing data from a tool like GSAK or Spinner, import the file twice in XData. One will create a file with diff --git a/xmldoc/formats/tmpro.xml b/xmldoc/formats/tmpro.xml index ee5457bd4..cf02509db 100644 --- a/xmldoc/formats/tmpro.xml +++ b/xmldoc/formats/tmpro.xml @@ -1,8 +1,8 @@ - TopoMapPro Places File. Reads and writes places files for -use in TopoMapPro topomappro.com). As this file + Reads and writes places files for +use in TopoMapPro places files). As this file type can store links other than web links, anything that is not a http url will be discarded. Note that this does not do datum conversions, so if your input file does not have WGS84/NZGD2000 data, your output diff --git a/xmldoc/formats/tomtom.xml b/xmldoc/formats/tomtom.xml index cb9b94726..5da5edc35 100644 --- a/xmldoc/formats/tomtom.xml +++ b/xmldoc/formats/tomtom.xml @@ -1,7 +1,7 @@ - This format can read and write TomTom .ov2 (POI) files, + This format can read and write TomTom .ov2 (POI) files, as used by the TomTom GO and TomTom Navigator. It has been tested with an original TomTom GO running version 5.00 of the TomTom software. There may be some records that confuse the input module - diff --git a/xmldoc/formats/xmap.xml b/xmldoc/formats/xmap.xml index 2032e560b..5d843e9dd 100644 --- a/xmldoc/formats/xmap.xml +++ b/xmldoc/formats/xmap.xml @@ -1,8 +1,9 @@ - Delorme TopoUSA/XMap Conduit is one of the billion CSV -variants mentioned above. It's just like S&A with the addition of + Delorme TopoUSA/XMap Conduit is one of the bazillion +CSV variants +variants mentioned above. It's just like Delorme Streets & Atlas with the addition of a completely pointless line at the beginning and end of the file. This is the format used to hot-sync to XMap from withing TopoUSA. Done with help of Dan Edwards. diff --git a/xmldoc/formats/xmap2006.xml b/xmldoc/formats/xmap2006.xml index 06d591937..530403ef8 100644 --- a/xmldoc/formats/xmap2006.xml +++ b/xmldoc/formats/xmap2006.xml @@ -1,7 +1,9 @@ - Delorme XMap2006 Conduit is just like XMap, except there are + Delorme XMap2006 Conduit is just like +XMap +, except there are no spaces between fields and the coordinate format is slightly different. The completely pointless header and footer lines are the same, at least. Use this to create the XMapHHWptsSend.txt diff --git a/xmldoc/formats/xmapwpt.xml b/xmldoc/formats/xmapwpt.xml index cbd2481e1..ba949bf00 100644 --- a/xmldoc/formats/xmapwpt.xml +++ b/xmldoc/formats/xmapwpt.xml @@ -1,7 +1,7 @@ Delorme XMapHandHeld Street Atlas USA is another of the -billion CSV variants. This is the format used by XmapHH SA USA on (at -least) PocketPC O/S. +billion CSV variants. +This is the format used by XmapHH SA USA on (at least) PocketPC O/S. This XMap is not the same as the simpler -- 2.30.2